home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / bench.man < prev    next >
Encoding:
Text File  |  1990-02-16  |  3.5 KB  |  81 lines
  1. ' $Header: /sprite/src/cmds/bench/RCS/bench.man,v 1.2 90/02/16 11:10:44 jhh Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS BENCH cmds
  4. .BS
  5. .SH NAME
  6. bench \- Benchmark harness that coordinates multiple processes
  7. .SH SYNOPSIS
  8. \fBbench\fR [\fIoptions\fR] \fB-c\fP \fIcommand\fP
  9. .br
  10. \fBbench\fR \fB\-M\fP [\fIoptions\fR]
  11. .SH "OPTIONS"
  12. .IP "\fB\-M \fInumClients\fR" 14
  13. Run as master of the number of clients indicated.
  14. The master bench process should be started before any slaves.
  15. .IP "\fB\-S\fR" 14
  16. Run as a slave.  Use \fB-c\fP to specify a command.  The slave
  17. process will wait until all other slaves have registered with
  18. the master before executing their benchmark.
  19. .IP "\fB\-c \fIcommand args ...\fR" 14
  20. Follow this with the command to benchmark.  Execution search paths
  21. are not used (yet).  The command can be followed with any required arguments.
  22. .IP "\fB\-p\fR" 14
  23. Name of the pseudo-device used for coordination.
  24. .IP "\fB\-o \fIoutfile\fR" 14
  25. Output file in which execution statistics are placed.
  26. .IP "\fB\-f\fR" 14
  27. Flush the file system cache before executing the benchmark.
  28. .IP "\fB\-x\fR" 14
  29. Disable all system tracing before executing the benchmark.
  30. .IP "\fB\-h\fR" 14
  31. Enable taking of RPC timing histograms.  This is ok with -x.
  32. .IP "\fB\-d\fR" 14
  33. Don't sync the file system cache at the end of the benchmark.  Normally
  34. this is done after the benchmark completes and before the file system
  35. I/O statistics are taken.
  36. .IP "\fB\-s\fR" 14
  37. Use signals instead of pseudo-devices for rendez-vous.
  38. .IP "\fB\-P \fIseconds\fR" 14
  39. Pause for some seconds before getting the final statistics.  Only
  40. applies to the master bench process.
  41. .IP "\fB\-w\fR" 14
  42. Causes the master process to wait for a USR1 signal before it allows the
  43. slaves to begin running.  This option must be used with the \fI-M\fR option,
  44. and cannot be used with the \fI-s\fR option.
  45. .BE
  46.  
  47. .SH DESCRIPTION
  48. .PP
  49. Bench is a harness for other programs that executes them and
  50. takes system statistics.
  51. The command to benchmark follows the \fB-c\fP option.  Currently
  52. bench does not used the execution search path, so the command
  53. has to be a valid pathname.  (This should be fixed!)
  54. In its simplest form (no \fB-S\fP or \fB-M\fP) bench executes a
  55. single process and generates output to ``bench.out'' or
  56. to the file specified by the -o option.
  57. The default behavior is that the execution time and CPU utilization
  58. are recorded after the benchmarked process completes,
  59. then the file system cache is written back and
  60. file system statistics are recorded.
  61. The file system cache can be flushed before the benchmark using
  62. the \fB-f\fP option.  The cache write-back at the end of the
  63. run can be disabled with the \fB-d\fP option.  The \fB-x\fP option
  64. turns off various kernel tracing that can slow down execution.
  65. .PP
  66. Multiple processes can be coordinated using the
  67. \fB-M\fP and \fB-S\fP options.  First a master bench process is
  68. started with the \fB-M\fP option.  This option is followed by an
  69. integer that indicates the number of slaves to expect.  The
  70. master process creates a pseudo-device that will be used to
  71. coordinate the slaves.  Each slave benchmark is started
  72. using the \fB-S\fP option.  The slaves contact the master,
  73. and after they all make contact the master lets them proceed.
  74. The master bench process also takes system statistics during
  75. the execution of all the slaves.  It is generally run on
  76. the file server in order to measure the load presented by the slaves.
  77. Note that the master doesn't run a command itself, so no \fB-c\fP
  78. argument is needed with \fB-M\fP.
  79. .SH KEYWORDS
  80. benchmark, statistics, timing
  81.